The Mac 1996 October/The Mac (October 1996).dmg/Web Authoring/WWWStat4Mac 1.2.1/WWWStat4Mac Prefs

Text File | 1996-05-19 | 14.2 KB | 312 lines | [TEXT/R*ch]

# --------------------------------------
# WWWStat4Mac  © P.J.Hardman 1995-1996. email [e-mail].
#          Preferences file.
# WWWStat4Mac is Shareware ($10). Don't forget to REGISTER your copy.
# This file should be in the preferences folder in the system folder.
# --------------------------------------
# Any line that starts with a # is ignored. The program doesn't expect
# to find the information below in the any order but it does help to keep things tidy.
# Each option has two parts. The option identifier and the argument. Please make sure
# that you have both of these parts as I can't guarantee what might happen if one is missing.
#
# Here we go!
#
# If you've been good and sent in you registration fee, then you will have got a message from
# kagi telling you how to register the program. To make it a bit easier I've even added the
# option for you to fill in below. Just type in the code.
#
registration_code TYPE_CODE_HERE!
#
# First lets start with the basic file generation options.
# What do you want the file to be called? This is just the default name that appears in
# the programs Save Dialog or the filename if you have auto_save turned on.
# Note that the file will be saved in the same directory/folder as the log file.
#
file_name statistics.html
#
# Do you want to automatically save the output file. This option means that a file with
# the name file_name is created. If a file with this name already exists it is overwritten.
# [on/off]. When a file is created automatically, it is saved in the SAME FOLDER as the log
# file that you created it from.
#
auto_save off
#
# Which application would you like to have created the file?
# For example BBEdit is R*ch. SimpleText is ttxt.
#
file_creator R*ch
#
# Do you want the errors to be excluded?.For example if a file doesn't exist and the request
# fails then we don't add it to the list of files requested.
# However the site that tried to access the file will be included. [on/off]
#
exclude_errors on
#
# How many sites and files do you want to keep track of?
# ••NOTE••. These two options are currently unimplemented.
# A future version will use these to dynamically allocate the required memory.
#
max_sites 2000
max_files 500
#
# The output file will always contain, as a bare minimum, a summary of the server traffic.
# Including the no.hits, no. sites, no. files and total bytes transfered.
# However the next 4 options can be added as needed. [on/off]
# 1. Site Statistics. (Show the top N sites or all if N=0).
# -------------------
#
site_stats on
#
# 2. File Statistics. (Show the top N files or all if N=0).
# -------------------
#
file_stats on
#
# 3. Robot Statistics. This attempts to list all the net robots,spiders and search
# engines that have accessed your server and requested the file robots.txt
#
robot_stats off
#
# 4. Domain Statistics. This makes a list of hits and bytes transfered to each of the domains.
# The domain list came from the following URL:
# http://www.ics.uci.edu/WebSoft/wwwstat/country-codes.txt.
# If you need to make additions to the file these can be added in the STR# resource ID 129.
#
domain_stats off
#
#
# Traffic Statistics.
# Do you want to see when your server is busiest? Which month had the most accesses? Which
# day of the week sees the most hits? Then this is where you set these options.
# If you want to collect statistics for the amount of traffic that you server is getting then
# you can request data covering several time spans. You can look at the data by Hour of Day,
# Day of Week,Day of Year, Week of Year, and by Month of Year. You can choose to have some or
# all of these options on at the same time.
#
# traffic_stats hourly
# traffic_stats daily
# traffic_stats weekly
# traffic_stats monthly
# traffic_stats dayofyear  ••NOTE•• This option is unimplemented at this time
#
# NEW IN VERSION 1.2
# How do you want to display your traffic? Do you want to see the number of bytes transfered or
# the number of accesses? You have three options bytes,hits or both.
#
# traffic_display both
#
# How many sites files and domains do you actually want to show?
# ••NOTE••. If you want show all of the sites/files/domains then make these values 0.
# ••NOTE••. If you have the output as tables (see later) then it is best to limit
# these values to less than 50. Otherwise browsers will require large amounts of memory to
# display these tables.
#
top_sites 0
top_files 0
# NEW IN VERSION 1.2
top_domains 0
#
# How do you want to sort the SITE data that is collected. You have five options
# [name/hits/bytes/date/visits].See later for info on how to specify a 'visit'.
# Sort by name sorts alphabetically. By hits, bytes and visits sort in descending order.
# By date sorts in reverse chronological order. So most recent sites come first.
#
sort_sites name
#
# How do you want to sort the file data that is collected. You have five options
# [name/hits/bytes/date/size].
# Sort by name sorts alphabetically. By hits, bytes and size sort in descending order.
# By date sorts in reverse chronological order. So most recent files come first.
#
sort_files bytes
#
# How do you want to sort the domain data that is collected. You have four options
# [name/hits/bytes/date].
# Sort by name sorts alphabetically. By hits and bytes sort in descending order.
# By date sorts in reverse chronological order. So most recent domains come first.
#
sort_domains hits
#
#    Now that you have defined what you want in the output file in the way of sites/files/domains
# it is now time to FINE TUNE the analysis of the information.
#
# Inclusions. This option allows you to define in the next section up to
# 50 sites and 50 files that you would like to explicitly include in the output. You might
# want to do this because you only want to look at a portion of your statistics file.
# You can later exclude any files that are included here, but that you don't want to show
# in the final result. For example gifs.
# ••NOTE••.ANY SITE OR FILE THAT IS NOT INCLUDED WILL BE EXCLUDED.
#
# First list each SITE that you want to INCLUDE on a separate line.
# Make sure that there is only one space between inclusion and the sitename.
# Don't forget to include the IP address in case the DNR resolver isn't active.
# Wildcards are also supported at either the beginning or end of a string but not
# in the middle.
#
# site_inclusion your.host.machine.here
# site_inclusion 1.2.3.4
# site_inclusioê  include all US commercial sites
#
# Now list each FILE that you want to include on a separate line.
# NOTE. Don't forget that you need to supply the full path name for the file as it would
# appear in the access log. These files are not case sensitive, as we convert all file
# names to lowercase before comparing them.
# Wildcards are also supported at either the beginning OR end of a string but not
# in the middle.
#
# file_inclusion *.gif  This would include all of the gif images.
#
# 6. Exclusions. This option allows you to define in the next section up to
# 50 sites and 50 files that you would like EXCLUDING from the output. You might
# want to do this to stop some private files from being display in the statistics file.
# Or to stop accesses from your own machine being added during heavy testing sessions.
# If a file is excluded then it's data is not addedêgrand total and it is not included
# in the total number of accesses.
#
# NOTE: If you want to exclude not only the site but also the files that it is accessing then
# set the site_and_file option to on. Otherwise the site will be excluded but the file that was
# accessed will still be counted.
#
site_and_file off
#
# NEW IN VERSION 1.2
# NOTE: If you want to exclude a file and also the site that was accessing it then
# set the file_and_site option to on. Otherwise the file will be excluded but the site that was
# accessed will still be counted.(unless excluded elsewhere)
#
file_and_site off
#
# Now list each SITE that you want to EXCLUDE on a separate line.
# ••NOTE•• Make sure that there is only one space between exclusion and the sitename.
# Don't forget to include the IP address in case the DNR resolver isn't active.
# Wildcards are also supported at either the beginning or end of a string but not
# in the middle.
#
# site_exclusion your.host.machine.here
# site_exclusion 1.2.3.4
# site_exclusion *.com   this would exclude all US commercial sites
#
# Now list each FILE that you want to exclude on a separate line.
# NOTE. Don't forget that you need to supply the full path name for the file as it would
# appear in the access log. These files are not case sensitive, as we convert all file
# names to lowercase before comparing them.
# Wildcards are also supported at either the beginning or end of a string but not
# in the middle.
#
# file_exclusion *.gif This would exclude all of the gif images.
file_exclusion /statistics.html
file_exclusion /robots.txt
#
# ••••• NOTE •••••
# All exclusions/inclusions are decided in the following order.
# 1. First check sites for inclusions. If included then carry on otherwise goto 4.
# 2. If included then check for exclusions. If not excluded then goto 4.
# 3. If site_and_file on then also exclude file.
# 4. Check for file inclusions. If included and not excluded in 3 then process.
# 5. If included check for exclusions. If not excluded then process.
# 6. If file_and site on then also exclude site.
# Process the site and file using current exclusions.
#
#    Misc Options.
# •••••••••••••
# Default File Mapping.
# When a request is made to the server and there is no file defined then this goes into the log
# as a request for /. But this is the same as requesting the default file so we can make hits
# on / look like hits on the default file. The default file is specified as the argument to
# this option. This replaces the old option map_default_to_home since not all servers have
# home.html as the default file. If the old option is used this automatically calls the
# map_default_to_file option with the argument home.html.
# NEW IN VERSION 1.2 This option is now extended to also include hits on folders for example
# /foo/bar/ appears in the log as /foo/bar/home.html  etc.
#
map_default_to_file home.html
#
# Custom Domains.
# If you want to add your own custom domains these can be specified by adding the new_domain
# option followed by the partial string that need matching. It is important that the whole
# option is in a single string. So for example :-
#
# new_domain UK_Academic.ac.uk
# new_domain UK_Commercial.co.uk
# new_domain Demon_UK.demon.co.uk
# new_domain Manchester_Univ.man.ac.uk
# new_domain Digital_Computer.dec.com
# new_domain IBM_Computer.ibm.com
# new_domain Apple_Computer.apple.com.
#            |<-  All One String   ->|
#  where .apple.com. is the string that is matched. Any
# sites ending like this will then be added to the domain called Apple_Computer.
# It is also possible to map machines to aliases too. For example
# new_domain Peter_Hardman.sodium.ch.man.ac.uk
# maps any hits from the machine sodium.ch.man.ac.uk to Peter_Hardman.
# There is a limit of 40 custom domains, but this should be more than enough :-)
#
# Calculating Visits
# More often than not a site will access the server and retrieve a collection of files. This
# set of files can be thought of as a single "visit" to the server. To define each "visit" we
# need to set a time between hits that we would expect to to occur in a single visit. So if you
# are serving large text files that need a while to read then set your visit time to be quite
# high. If on the other hand you are serving small text files or small graphics then you might
# want a small visit time. The time is defined in SECONDS. Default time is 300s (ie 5 mins).
#
visit_time 300
#
# Domain Name Resolving
# Version 1.1 adds the ability to resolve names using the domain name system. This gives you
# the opportunity to resolve names that were not resolved by the web-server either because the
# DNS was down, too slow, or turned off. You need to do two things to get this working.
# First set the resolve_names on or off. Then set the resolve_time to a value in seconds that
# you wish to wait for the DNS to return. If you set the time to 0 then the application will
# wait until the DNS returns or fails to find a name. Be warned however that this could take up
# to 120 seconds per item!!!!
#
resolve_names off
resolve_time  10
#
# Active Links.
# Do you want the files that are listed in the output to have active links that can be chosen
# in the web browser? This means that someone can look at the stats file and then jump to the
# most popular pages directly.
# If so then turn this option on. Otherwise the files will not be accessible directly from
# the stats file.
#
active_links off
#
# Create Tables?
# If you want your output to consist of Tables rather than a simple text file then leave this
# option off. Otherwise turn it on to get stunning tables :-) Of course you need a browser
# capable of displaying tables for example Netscape Navigator or Microsoft's Internet Explorer.
#
create_tables off
#
# NEW IN VERSION 1.2
# If you want an audible alert that the processing has finished turn on the following option
# otherwise set it to off.
#
completion_sound on
#
# NEW IN VERSION 1.2
# If you want to truncate the file names for cgi-hits then turn this option on. It will
# stop the name before the ?. This option will filter any such things include image map hits.
# In fact anything with a ? in it :-)
#
filter_cgi_hits on
#
# NEW IN VERSION 1.2
# Do you want to include a custom header or footer automatically to your outputed log file?
# For example you could add your company logo at the top and add a button bar at the bottom
# of the file. To do this make files called 'WWWStat4Mac Prefix' and 'WWWStat4Mac Suffix'
# and put them in the preferences folder.
# Then turn on the following options.
#
prefix_file off
suffix_file off
#
# ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
# ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
# If there are any problems with this file or you find something that is not explained
# fully then please drop me a line.
# Peter Hardman   email [e-mail]
# ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
# ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••